gdk: Drop gdk_device_get_last_event_surface()

This kind of transient state sets the expectative that events update
devices, while it's more accurate to say that devices generate events.
It does not make to expose this function anymore.

diff --git a/docs/reference/gdk/gdk4-sections.txt b/docs/reference/gdk/gdk4-sections.txt
index 158fba7ec17993281c63d837bb9a2b33fb3a00b1..474b1cdb2fc70c9aec60af210f55b8e67ac1fada 100644 (file)
--- a/docs/reference/gdk/gdk4-sections.txt
+++ b/docs/reference/gdk/gdk4-sections.txt
@@ -379,7 +379,6 @@ gdk_device_get_surface_at_position
 GdkTimeCoord
 gdk_device_get_axis
 gdk_device_get_axis_names
-gdk_device_get_last_event_surface
 
 <SUBSECTION>
 gdk_device_tool_get_serial

diff --git a/gdk/gdkdevice.c b/gdk/gdkdevice.c
index 29a1fcab47b9d096da7ed1dcd13af3c588c2c357..4889d7b232089f14f0f1566d791e4af59958661c 100644 (file)
--- a/gdk/gdkdevice.c
+++ b/gdk/gdkdevice.c
@@ -1282,33 +1282,6 @@ _gdk_device_surface_at_position (GdkDevice       *device,
                                                              mask);
 }
 
-/**
- * gdk_device_get_last_event_surface:
- * @device: a #GdkDevice, with a source other than %GDK_SOURCE_KEYBOARD
- *
- * Gets information about which surface the given pointer device is in, based on events
- * that have been received so far from the display server. If another application
- * has a pointer grab, or this application has a grab with owner_events = %FALSE,
- * %NULL may be returned even if the pointer is physically over one of this
- * application's surfaces.
- *
- * Returns: (transfer none) (allow-none): the last surface the device
- */
-GdkSurface *
-gdk_device_get_last_event_surface (GdkDevice *device)
-{
-  GdkDisplay *display;
-  GdkPointerSurfaceInfo *info;
-
-  g_return_val_if_fail (GDK_IS_DEVICE (device), NULL);
-  g_return_val_if_fail (device->source != GDK_SOURCE_KEYBOARD, NULL);
-
-  display = gdk_device_get_display (device);
-  info = _gdk_display_get_pointer_info (display, device);
-
-  return info->surface_under_pointer;
-}
-
 /**
  * gdk_device_get_vendor_id:
  * @device: a physical #GdkDevice

diff --git a/gdk/gdkdevice.h b/gdk/gdkdevice.h
index 0eefbb6cac84972b8eab4536e779a16ee48a5c68..058d0b67bd9bf050097bbf62c7d6ff4fd6c56f7c 100644 (file)
--- a/gdk/gdkdevice.h
+++ b/gdk/gdkdevice.h
@@ -143,9 +143,6 @@ GList *      gdk_device_list_physical_devices (GdkDevice     *device);
 GDK_AVAILABLE_IN_ALL
 GdkDeviceType gdk_device_get_device_type (GdkDevice *device);
 
-GDK_AVAILABLE_IN_ALL
-GdkSurface *gdk_device_get_last_event_surface (GdkDevice *device);
-
 GDK_AVAILABLE_IN_ALL
 const gchar *gdk_device_get_vendor_id       (GdkDevice *device);
 GDK_AVAILABLE_IN_ALL